今日主題

今天迎來第一個主題Day 1: Fork a collection，所以話不多說，同昨天的fork流程先把主題複製到自己的工作區吧。

忘了從哪裡進行複製嗎? 點這裡

之後每天的挑戰也都需要先複製到自己的工作區，回到自己的工作區展開剛複製來的Collection，可以看到每天的挑戰內容都會包含兩個資料夾，一個是挑戰內容，另一個則是用來提交結果用來確認是否通過。點擊第一個資料夾Fork a collection可以看到右邊Documentation文件區塊列出了今日挑戰的步驟

新分頁

但直接跳到下一個步驟會使得當前的Tab分頁被新頁面取代，切換上會有些困擾，這時候可以透過Open In Tab來另開分頁，就不會取代原本頁面了。下面以echo這個request為例，展開一個新分頁。然後通過其Documentation部分去了解接下來的流程，我們將需要試著發出一個預先準備好的請求，並取得回應裡關於user-agent所帶的資訊，那便是今天挑戰的答案，需要複製起來在後面步驟進行提交。

Request

展開成新分頁後，能看到上半是屬於Request的部分，其中比較重要的部分如下

• POST: 這邊指的是該API的Method，這邊是個下拉選單，點開可以看到如GET、PUT等等常見方法
• https://postman-echo.com/post: 這個欄位是Request URL的內容
• Body: Request Body，可以看到目前是JSON格式的資料

  {
    "payload": "hello world"
  }
  

• Send: 按下去便會依照當前設置將Request發出

  

Response

發出Request後，下方的部分就是該API Response的內容，通常我們會在意幾個部分:

• HTTP status code: 這邊取得的是200表示沒有問題，關於其他數字代表的狀態可以參考這裡，通常2xx表示成功，4xx表示客戶端有問題，而5xx表示伺服器端錯誤

• Response time: 表示從發出請求後過了多久取得API的回應，這邊表示共花費了1442ms

• Response size: 整包回應的資料大小

• Response body: API回應的內容，這支API是以JSON格式來呈現，可以看到我們今日挑戰的答案就藏在這內容裡

       "user-agent": "PostmanRuntime/7.29.2",
  

  

Submit

找到答案後，接下來就需要展開另一個資料夾Submit your solution，開啟下面的request submit，透過它的文件來看看如何送出答案。

從submit我們可以發現它是一個GET request，所以我們可以把答案直接放到URL裡，或是針對Params去修改value，都是異曲同工，在這邊不妨直接送出錯誤的答案來看看結果。

這時候能看到在下方Response區塊的Test Results看到總共三項的測試沒有全部成功，從這裡我們能夠瞭解到，今天的挑戰其實設定好了測試項目，會去驗證我們所提交的答案，最後告之通過與否。所以改成正確答案PostmanRuntime/7.29.2之後重新發送請求，就能夠看到三項測試全部成功通過。對今日挑戰所使用到的測項有興趣的話可以從上方Request區塊的Tests去看，但之後會有文章專門講測試，因此這邊就不再贅述。

今日回顧

送出答案通過測試後，其實也表示今日的挑戰成功通過，讓我們從頭回顧一下今日的重點

• Forking a collection: 重溫了如何將collection複製到其他的工作區
• Viewing documentation: 知道文件的位置，之後也能自行編輯
• Sending a request: 體驗到Postman最初的需求 -- 發出請求

第一個挑戰果然只是讓使用者熟悉熟悉介面，了解基本的流程，不得不說這種互動型的教學所帶來的沉浸感讓人學習動力滿滿呢!